WORKBENCH 

FOR  THE  COMMODORE  AMIGA  USER 

Registered  by  Australia  Post  -  Publication  No.  VBG7930 

Number  9  Circulation:  500  ~~  February  1987 


Next  Meeting 

Sunday,  February  8th,  1987  at  2pm 

AUG  meetings  are  held  at  Victoria  College,  Burwood  Campus 
in  Lecture  Theatre  2.  Melways  map  61  reference  B5. 


Amiga  Users  Group,  P0  Box  48,  Boronia,  3155,  Victoria,  Australia 

AMIGA  is  a  trademark  of  Commodore- Amiga,  Inc 
The  Amiga  User's  Group  has  no  affiliation  with  Commodore 


Amiga  Workbench 


February  1987 


Page  1 


AMIGA  Users  Group 

P.O.  Box  48,  Boronia,  3155,  Victoria,  Australia 


Amiga  Users  Group 

The  Amiga  Users  Group  is  a  non-profit,  self-help  group, 
made  up  of  people  Interested  In  the  Amiga  computer  and 
related  topics. 

Club  Meetings 

Club  meetings  are  held  at  2pm  on  the  second  Sunday  of 
each  month  at  Victoria  College,  Burwood  Campus,  In  Lecture 
Theatre  2.  Details  on  how  to  get  there  are  on  the  back  , 
cover  of  this  newsletter.  The  dates  of  the  next  few 
meetings  are: 

Sunday,  February  8th  at  2pm 
Sunday,  March  8th  at  2pm 
Sunday,  April  12th  at  2pm 

Production  Credits 

This  month's  Amiga  Workbench  was  edited  by  Peter 
Jetson.  Equipment  and  software  used  was:  TurboDOS  S-100 
computer,  Diablo  630  printer,  Gemini  lOx  printer,  Wordstar 
and  Fancy  Font.  Now  that  Desktop  Publishing  software  for 
the  Amiga  is  becoming  available,  we  might  soon  be  able  to  do 
the  whole  newsletter  on  an  Amiga. 

Copyright  and  Reprint  Privileges 

Articles  herein  that  are  copyrighted  by  individual 
authors  or  otherwise  explicitly  marked  as  having  restricted 
reproduction  rights  may  not  be  reprinted  or  copied  without 
written  permission  from  the  Amiga  Users  Group  or  the 
authors.  All  other  articles  may  be  reprinted  for  any  non¬ 
commercial  purpose  if  accompanied  by  a  credit  line  including 
the  original  author's  name  and  the  words  "Reprinted  from 
Amiga  Workbench,  newsletter  of  the  Amiga  Users  Group,  P0  Box 
48,  Boronia,  3155". 

Contributions 

Articles,  papers,  letters,  drawings  and  cartoons  are 
actively  sought  for  publication  in  Amiga  Workbench.  It 
would  be  appreciated  if  contributions  were  submitted  on 
disk,  since  that  means  they  don't  have  to  be  re-typed!  We 
have  access  to  a  wide  range  of  computers,  so  we  should  be 
able  to  accept  almost  any  type  of  disk,  but  Amiga  disks  are 
certainly  the  easiest.  All  disks  will  be  returned! 

Absolute  deadline  for  articles  is  the  last  weekend  of  the 
month  before  the  cover  date.  Contributions  can  be  sent  to: 

The  Editor,  AUG,  PO  Box  48,  Boronia,  3155 

(Note  the  new  address) 


AUG  Users  Group  Disks 

Disks  from  the  Amiga  Users  Group  Library  are  available 
on  quality  3.5"  disks  for  $10  each  including  postage  on  AUG 
supplied  disks,  or  $2  each  on  your  own  disks.  The  group 
currently  holds  58  public  domain  volumes,  sourced  from  the 
USA,  with  more  on  the  way  each  month. 

Meeker* s  Discounts 

The  Amiga  Users  Group  is  currently  negotiating 
discounts  for  its  members  on  hardware,  software  and  books. 
Members  will  be  notified  when  negotiations  are  complete. 

Currently,  Technical  Books  in  Swanston  Street  in  the 
city  offers  AUG  members  a  10%  discount  on  computer  related 
books,  as  does  McGills  in  Elizabeth  Street.  Just  show  your 
membership  card.  Although  we  have  no  formal  arrangements 
with  other  companies  yet,  most  seem  willing  to  offer  a 
discount  to  AUG  members.  It  always  pays  to  ask! 

Meriership  and  Subscriptions 

Membership  of  the  Amiga  Users  Group  is  available  for  an 
annual  fee  of  $20.  To  become  a  member  of  AUG,  fill  in  the 
membership  form  in  this  issue  (or  a  photocopy  of  it),  and 
send  it  with  a  cheque  for  $20  to: 

Amiga  Users  Group,  PO  Box  48,  Boronia,  3155 


Amiga  Users  Group  Cownittee 

John  Holland  .  .  .  (Co-ordinator)  ...  348  1358  Carlton 
Bob  Scarfe  ....  (Vice  Co-ordinator)  .  376  4143  Kensington 
Ron  Wail  .  .  .  .  .  (Meeting  chairman)  .  878  8428  Blackburn 

Eric  Salter  .  .  .  (Secretary) . 861  9117  Kew 

Paul  Radford  .  .  .  (Treasurer)  .  663  3951  BH  only 

Neil  Murray  .  .  .  (Membership)  ....  792  9666  Dandenong 

Stephen  Thcxnas  .  .  (Membership)  ....  830  5783  Canterbury 
Peter  Jetson  .  .  .  (Newsletter  editor)  .  762  1386  Boronia 

Geoff  Shell  .  .  .  (Assoc  editor)  ...  509  3151  Armadale 

Jo  Santamaria  .  .  (Assoc  editor)  ...  836  9129  Canterbury 
Ron  Van  Schyndel  .  (Librarian-  books)  .  882  7264  Hawthorn 
Geoff  Wood  ....  (Librarian-  books)  .  580  7463  Aspendale 

Ron  wail  .  (Librarian-  software)  878  8428  Blackburn 

Mike  Creek  ....  (Librarian-  software)  878  9039  Blackburn 
Bohdan  Ferens  .  .  (Purchasing)  ....  792  1138  Dandenong 
Justin  Somers  .  .  (Without  portfolio)  .  553  0379  Moorabbin 

When  phoning  committee  members,  please  try  to  be  a  bit 
considerate  and  not  call  at  meal-times,  late  at  night,  or 
during  popular  TV  programs.  If  you  only  have  a  general 
query,  try  to  ring  the  member  who  lives  closest  to  you. 


Have  you  noticed  our  change  of  address? 
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Defenders  of  the  Crown,  a  review  by  Fergus  Bailey 

I  would  like  to  start  by  saying  that  I  do  not  really 
enjoy  computer  games.  Sure,  I  occasionally  crank  up 
Hitchhlckers  Guide  To  The  Galaxy,  or  more  lately  Leather 
Goddesses  of  Phobos,  but  on  the  whole  I  don't  spend  much  time 
on  games. 

Most  games  to  date  for  the  Amiga  have  been  directly 
ported  from  lower-powered  computers  and  have  been  very 
disappointing  considering  the  Amiga's  capabilities.  I  waited 
with  anticipation  for  the  release  of  Marble  Madness,  and  was 
pleased  to  see  a  game  that  started  to  do  justice  to  the 
AMIGA,  though  I  was  a  little  disappointed  that  there  were 
only  six  levels  In  the  game.  Surely,  I  thought,  with  the 
great  graphics  and  sound  laid  on  with  the  Amiga,  there  must 
be  potential  for  a  game  that  would  even  get  a  play-a- 
computer-game-once-in-a-blue-moon  type  like  me  interested. 

Finally  that  game  is  here.  It’s  a  "Cinemaware 
Production,  an  Interactive  movie"  from  Mlndscape,  by  the 
title  of  Defenders  of  the  Crown.  On  booting  up  the  disks 
(Yes,  Virginia,  there  are  two  of  them),  you  are  greeted  with 
credits,  an  opening  screen  which  sets  the  high  standard  that 
Is  maintained  throughout  the  game,  and  a  cast  of  characters 
whom  you  will  probably  meet  as  you  play.  After  being  told 
the  story  so  far,  you  find  yourself  in  Sherwood  Forest 
talking  to  Robin  Hood,  who  tells  you  that  you  have  the  job  of 
driving  the  Normans  from  England  (You  will  play  the  part  of  a 
Saxon).  Robin  pledges  you  his  help  three  times  during  the 
campaign.  If  you  ask  for  help  more  than  three  times  in  one 
game,  Robin  will  politely  tell  you  that  yoi/re  on  your  own. 

The  most  outstanding  thing  about  Defenders  is  the  high 
quality  graphics.  Jim  Sacks  is  the  Art  Director  and  the  art 
is  just  mind  blowing  (Sacks'  art  was  on  the  first  slide  show 
I  ever  saw  for  the  Amiga  and  his  work  is  still  the  best  free 
hand  Amiga  pictures  I  have  seen).  The  attention  to  detail  is 
fantastic,  and  the  whole  production  is  a  great  compliment  to 
the  entire  art  team. 

Defenders  seems  to  have  something  for  everyone;  It 
Includes  strategy,  adventure  and  arcade-action  with  top  notch 
graphics  and  a  good  quality  story  line.  Without  telling  you 
too  much  about  the  story.  Defenders  lets  you  go  raiding,  go 
jousting,  rescue  maidens  and  invade  other  territories.  The 
object  of  the  game  is  to  end  up  in  control  of  England  by 
driving  the  Normans  from  the  country.  Although  this  may  not 
sound  like  much,  there  are  five  other  lords,  all  of  whom  are 
also  Interested  In  ruling  England,  and  believe  me,  doing 
battle  with  an  opponent  like  Edmund  the  Grim  or  Wolfrlc  the 
Wild  Is  no  easy  task. 

As  mentioned  above,  Defenders  comes  with  two  disks  and 
Is  best  played  on  a  twin-drive  system,  The  game  is  disk- 
intensive  and  although  I  had  been  told  that  Defenders  could 
be  played  on  a  single  drive  Amiga,  I  was  doubtful  that  this 
would  work  very  well.  To  prove  the  point,  I  played  a  game 
using  just  my  Internal  drive  and  was  surprised  to  find  that 
the  game  played  quite  well.  In  around  forty  minutes  of  play, 
I  had  to  swap  disks  fourteen  times.  I  think  that  Defenders 
would  run  best  with  a  two  meg.  RAM  expansion  board  but  alas, 
these  are  so  expensive  that  not  many  Amiga  owners  will  get  a 
chance  to  try  this. 

Despite  all  the  great  features,  I  still  have  a  few 
complaints  about  Defenders,  the  main  one  being  that  there  is 
no  joystick  Input.  Every  time  you  go  raiding,  the  sword 
fight  with  your  opponent  results  in  you  bashing  the  daylights 
out  of  your  mouse.  A  far  better  idea  would  have  been  to  use 
the  mouse  for  movement  and  the  second  port  with  a  joystick 
for  the  action  sequences.  I'm  sure  that  mouse  manufacturers 
will  be  laughing  all  the  way  to  the  bank  over  this  "feature". 
My  other  complaint  Is  the  lack  of  a  game-save  option;  this  is 
a  bit  of  a  nuisance,  though  with  a  program  this  big  it  would 
have  been  a  bit  of  a  problem.  Ifs  not  a  major  concern, 
however,  since  a  game  only  lasts  about  an  hour  or  so  before 
you  either  lose  your  castle  or  win  control  of  England. 

Defenders  of  the  Crown  Is  the  best  game  I  have  seen  for 
the  Amiga  and  I  would  highly  recommend  it  to  anyone  with  an 
interest  in  games. 

--  Fergus  Bailey 


Superbase  Personal 

My  copy  of  Superbase  Personal  arrived  only  a  fortnight 
ago,  and  I  am  already  using  it.  It  is  important  to  be  aware 
that  I  come  to  this  from  the  perspective  of  a  busy  Parish 
Minister,  so  I  do  not  have  a  great  deal  of  time  to  be  getting 
into  why  and  how  the  thing  works,  and  neither  am  I  a 
programmer,  so  the  thing  has  to  be  simple  and  easy  to  use. 

Right  from  the  outset,  I  found  Superbase  Personal  a 
delight.  Like  all  previous  software  from  Precision  Software, 
It  is  well  packaged  and  well  presented.  Precision  wrote  Easy 
Script  (word  processor)  and  Svpartase  64  (database)  for  the 
Commodore  64,  and  I  speak  with  considerable  experience  and 
pleasure  of  these  programs. 

My  initial  Impression  of  Supertase  Personal  is  that  it 
will  more  than  fulfil  my  expectations. 

1  What  you  get  for  your  money  Is  a  disk  with  the  program 
on  It,  a  manual  and  a  "dongle"  (a  copy  protection  device). 

The  manual  Is  clear  and  simple  with  well  layed-out  and 
helpful  tutorials,  but  with  one  annoying  feature:  the  type- 
style  used  In  the  manual  has  a  peculiar  "1"  which  makes  It 
hard  to  distinguish  from  the  letter  "1". 

S«q>erbase  makes  It  easy  to  set  up  files,  records  and 
fields  and  to  move  around  on  the  screen  using  the  mouse.  In 
fact,  the  whole  system  can  be  operated  by  mouse.  The  program 
Is  menu  driven  and  allows  you  to  very  quickly  re-arrange  your 
data  and  print  It  or  display  It  or  even  put  It  Into  another 
file  simply  by  clicking  on  the  various  gadgets  and 
requesters.  The  data  Is  stored  In  a  way  that  enables  the 
system  to  very  quickly  find  anything  you  want.  The  heart  of 
Superbase  Is  the  'filter*  which  enables  you  to  'home-in*  on 
precisely  the  piece  of  Information  you  want.  I  have  already 
used  It  to  set  up  various  operations  for  which  I  was  using  a 
spreadsheet,  and  such  Is  the  ease  of  use  that  a  complete 
novice  could  operate  It  within  a  few  minutes. 

Superbase  Personal  Is  an  excellent  program,  and  a  worthy 
successor  to  Superbase  64  I  believe  that  Precision  are  soon 
to  offer  an  upgrade  called  Superbase  Professional,  which  will 
Include  a  word-processor.  If  It  Is  as  good  as  the 
combination  of  Superbase  64  and  Easy  Script,  then  I'll  junk 
Textcraft  In  favour  of  the  upgrade  as  fast  as  I  can!  One  of 
the  key  applications  for  which  I  need  a  word-processor  Is  to 
send  out  form  letters  Into  which  I  can  merge  files  and  data 
from  a  database  and  I  presently  find  that  without  the  mall- 
merge  function  I  am  severely  limited. 

I  would  be  happy  to  demonstrate  what  I  have  learned 
about  how  to  use  Supertese  to  anyone  Interested. 

—  David  Peel 

I've  also  got  a  few  questions.  Is  there  anyone  who 
knows  of  a  program  which  will  enable  my  wife  to  write  musical 
scores  using  the  Amiga?  We  don't  want  the  sort  of  "mickey- 
mouse"  scores  which  The  Music  Studio  produces,  but  properly 
written  scores  where  notes  can  be  joined  together  and  key 
signatures  changed  In  the  same  line  and  all  that  technical 
music  stuff.  We  don’t  need  It  to  sound  or  play  the  music.  I 
guess  what  we  are  looking  for  Is  a  sort  of  a  "word  processor" 
for  music.  Is  there  anyone  out  there  who  can  help? 

I  wrote  this  review  using  Textcraft,  and  If  I  sound  a 
bit  frustrated  with  it,  that  is  a  fair  assessment.  Is  there 
anyone  who  knows  how  to  open  a  document  without  having  to 
load  the  whole  directory  each  time?  I  want  to  know  how  to 
load  a  specific  file,  so  If  anyone  knows  how,  please  tell  me! 


—  David  Peel 
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Introduction  to  talgaDOS,  Part  2 

In  my  last  article,  we  looked  at  AmlgaOOS,  the  operating 
system  of  the  Amiga,  and  how  It  fits  In  with  Workbench  and 
the  CLI.  We  also  looked  briefly  at  both  the  CLI  and 
Workbench,  outlining  what  their  functions  were  and  the 
relationship  between  them.  This  month,  we  will  look  more 
closely  at  the  CLI,  and  find  out  what  It  is  and  how  much 
power  It  gives  the  user.  Hopefully,  you  will  begin  to  use 
the  CLI  and  discover  the  real  Amiga  and  its  capabilities. 


The  CLI,  or  command  line  interface,  reads  text  from  a 
device  (which  Is  usually  the  keyboard,  but  It  may  be 
something  else)  and  attempts  to  load  the  program  that  was 
named  on  the  command  line.  If  the  program  was  loaded 
correctly,  the  CLI  allows  It  to  begin  executing  (running). 
If  It  was  not  loaded  properly,  It  says  so  with  an  error 
message!  e^/'error  121:  file  Is  not  an  object  module"  or 
"103:  Insufficient  free  storage"  or  some  other  cryptic 
message  (but  at  least  It's  better  than  most  other  operating 
systems).  For  example: 


l>d1r 

When  you  type  this  command,  the  CLI  sends  requests  to 
AmlgaDOS  to  find  the  file  “dir".  When  It  Is  found,  further 
requests  are  Issued  to  bring  the  file  off  disk  and  Into 
memory.  When  this  is  completed,  the  CLI  relinquishes  control 
and  goes  to  •''sleep*,  and  allows  the  program  "dir"  to  run. 

"dir"  will  then  display  a  directory  listing  on  the  screen. 
This  process  Is  virtually  Identical  every  time  you  type  a 
command  at  the  "1>"  prompt.  This  Is  a  very  simplified 
outline  of  what  actually  takes  place,  but  Is  essentially 
correct,  and  any  more  detail  serves  only  to  confuse  at  the 
moment. 

Let's  look  at  some  of  the  commands  that  are  available  to 
you  on  the  "Workbench"  disk  of  your  Amiga.  They  are  found  In 
the  "c"  directory  of  your  disk.  As  "Workbench"  comes,  It  Is 
configured  to  start  up  In  the  Workbench  iconic  Interface.  To 
enable  you  to  use  the  CLI,  you  must  do  one  of  two  things:  1. 
You  must  enter  the  preferences  program  and  select  the  on 
position  for  the  CLI  on/off  switch.  You  must  then  save  this 
configuration.  Now  when  you  open  the  system  drawer,  you  will 
find  another  Icon  has  appeared  called  CLI.  You  may  now  open 
It  up  and  you  have  a  CLI  window  to  play  with.  2.  If  you  want 
your  Amiga  to  start  up  In  the  CLI  when  It  first  comes  on,  you 
will  have  to  edit  the  file  "startup-sequence"  found  In  the 
"s"  directory  so  that  "Workbench"  Is  not  loaded  and  the 
Initial  CLI  Is  not  closed. 


DIR  -  The  Directory  Command 

This  is  the  single  most  used  command  on  any  computer. 

It  allows  you  to  see  the  files  on  your  disk.  If  you  type 
"dir".  It  will  display  the  names  of  files  and  directories  In 
the  current  directory.  The  concept  of  "current  directory"  Is 
an  easy  one.  If  you  think  of  an  Inverted  tree  with  the  root 
directory  being  at  the  top  and  branches  representing 
directories  with  files  hanging  from  these  branches,  you 
understand  the  hlerachlcal  directory  structure  of  AmlgaDOS. 
Now  the  "current  directory"  can  be  set  with  the  "CD"  command 
and  Is  like  setting  your  pointer  to  one  of  the  branches.  Now 
the  DIR  command  will  only  display  files  or  directories  at 
that  level.  The  DIR  command  has  several  options,  the  most 
useful  one  Is  "opt  a"  which  will  let  you  see  all  files  and 
directories  from  your  current  directory  down.  If  CD  Is  set 
to  the  root  directory,  then  an  "opt  a"  will  display  the  whole 
disk  contents.  Some  examples: 

Dir  -  lists  the  files  &  Directories  In  the  CD 
Dir  opt  a  -  lists  all  files  &  Directories  from  the  CD 
Dir  DFO:  -  list  the  files  etc  on  drive  DFO 
Dir  DF1:  -  as  above  but  on  drive  DF1 
Dir  >"PRT:"  opt  a  -  re-directs  output  to  the  printer 
Instead  of  the  screen. 


>  *  <  -  Re-direction  commands 

The  UNIX(tm)-l Ike  >  &  <  re-direction  directives  are  used 
to  alter  which  file  the  information  Is  sent  to  or  got  from. 
The  ">"  tells  the  operating  system  to  re-direct  output  to  the 
file  mentioned  after  the  symbol.  The  file  may  be  a  disk  file 
or  a  device  (like  the  printer)  or  anything  else  that  will 
accept  output  from  the  computer.  Similarly  the  "<"  symbol, 
allows  a  program  to  accept  its  Input  from  a  file  other  than 
the  Keyboard  e.g.  the  external  serial  port  or  a  disk  file. 
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Useful  commands  -  Dlskcopy,  Copy,  Format 

Dlskcopy  allow  you  to  copy  one  disk  to  another.  It  will 
not  allow  you  to  copy  "copy  protected"  disks  however.  It  Is 
Invoked  simply: 

Dlskcopy  DFO:  to  DFO: 

This  will  copy  one  disk  to  another  using  DFO.  Of  course 
you  will  have  to  swap  disks  a  minimum  of  3  times  with  this 
command.  If  you  have  a  second  (external)  drive  you  could 
type  Dlskcopy  dfO:  to  dfl:  and  no  swaps  would  be  necessary. 

Copy  allows  single  files  to  be  transferred  from  one 
place  to  another.  £g. 

Copy  DF0:foo  to  DF1: 

which  will  copy  the  file  called  "foo"  from  DFO  to  DF1. 

You  can  copy  from  device  to  device,  too. 

Copy  DF0:foo  to  RAM: 

will  copy  "foo"  to  the  RAMdlsk  device. 

Format  enables  us  to  format  a  blank  disk  for  use  and 
give  the  disk  a  name.  eg. 

Format  drive  DFO:  name  Foo 

will  format  the  disk  In  drive  DFO  and  name  It  "Foo".  It 
will  be  empty,  but  we  can  now  copy  files  to  It  for  storage. 

The  various  commands  in  the  "c"  directory  are  useful  In 
different  situations.  Some  will  probably  never  be  used  by 
the  average  user.  For  a  full  explanation  of  the  commands,  a 
book  like  the  "AmlgaDOS  Manual"  by  Bantam  is  essential.  If 
you  are  serious  about  learning  to  use  the  CLI  then  get  one  - 
they  are  worth  It. 

In  the  next  article,  we  will  look  at  more  of  the 
commands  and  some  features  such  as  wildcards,  a  bit  more  on 
re-direction  and  look  at  how  to  create  "execute"  files  and. 

If  room  permits,  look  at  how  the  Amiga  Terminal  Is  used 
practically.  But  as  a  preamble  to  further  articles,  lets 
take  a  look  at  how  AmlgaDOS  sees  the  terminal. 

The  taiga  Terminal  -  The  Console  Device 

As  we  mentioned  In  the  last  article,  the  CLI  is  like  the 
traditional  Interface  that  most  computers  have,  for  example, 
the  "A>"  prompt  under  MS-DOS  on  the  IBM-PC  and  clones,  the 
"1A>"  prompt  of  CP/M  and  TurboDOS.  They  are  all  essentially 
the  same,  allowing  the  user  to  type  commands  to  the  computer 
using  a  terminal  which  Is  made  up  of  a  screen,  a  keyboard  and 
some  electronics,  plugged  Into  the  computer.  In  the  Amiga 
however,  there  Is  no  terminal  as  such,  but  there  Is  a 
program,  called  the  console  device,  which  makes  the  special 
chips  and  other  hardware  and  software  emulate  a  terminal. 

This  terminal  looks  to  your  program  (and  you)  to  be  an  ANSI 
(American  National  Standards  Institute)  x3.64  standard 
terminal. 

To  most  people,  a  terminal  Is  a  screen  and  keyboard  that 
Is  separate  from  the  computer,  which  physically  resides 
somewhere  else.  The  Amiga  Is  different  only  In  the  fact  that 
the  terminal  Is  part  of  the  computer  hardware  and  Its 
functioning,  intimately  related  to  the  functioning  of  the 
whole  system  (and  therefore  can't  really  be  regarded  as  a 
separate  entity).  The  CLI  communicates  with  you  via  this 
Console  device  (terminal).  The  Console  device  then  receives 
your  Input  (from  keyboard  and  mouse),  from  the  Input  device 
and  sends  output  to  the  screen  via  the  layers  library  (which 
arbitrates  between  different  programs  that  want  to  write  to 
the  screen,  and  essential  in  a  multi-tasking  environment). 

The  Input  device  Itself  uses  the  Keyboard  and  gameport 
devices  for  keyboard  and  mouse  Input  respectively.  So  you 
see,  It  Is  all  quite  complicated,  trying  to  emulate  a 
terminal.  However,  this  Is  not  a  real  terminal  but  a 
^virtual'  one.  There  can  be  up  to  20  CLI's  open  (depending 
on  available  memory)  and  each  Independent!  Each  with  Its  own 
window,  and  each  window  having  a  console  device  attached  to 
it,  acting  like  a  full  ANSI  x3.64  terminal.  Neat  Huh!  This 
is  one  manifestation  of  the  multi-tasking  (and  potentially 
multi-user)  environment  of  the  Amiga. 
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An  Introduction  to  Writing 
Your  Own  Device  Drivers 
by  Alan  Kent 

Part  2 

Writing  a  Device  Driver 

So  now  that  we  know  what  a  device  driver  Is,  how  do  we 
go  about  writing  one?  In  the  RKM:  libraries  and  devices 
appendix  F  a  sample  device  driver  written  In  assembler  is 
shown.  Looking  at  the  code,  I  suspect  It  contains  a  few 
errors.  Some  pieces  of  code  just  didn't  make  sense  to  me. 
After  looking  at  It  for  a  while  and  (hopefully) 
understanding  how  It  works,  I  threw  It  away  and  started 
again  from  scratch.  The  example  in  the  manual  Is  meant  to 
be  able  to  automatically  load  from  disk.  As  I  mentioned 
before,  I  did  not  worry  about  this  as  I  wanted  to  get 
something  working  as  quickly  as  possible  and  automatically 
loading  C  programs  looked  like  It  could  be  a  bit  of  a 
problem  (actually,  one  of  the  manuals  stated  It  was  not 
possible). 

When  writing  a  device  driver,  there  are  two  main 
sections  of  code.  The  first  section  looks  very  much  like  a 
library  -  and  In  fact  shares  many  structures  and  functions 
with  libraries.  This  provides  a  nice  consistent  interface 
between  the  device  driver  and  other  programs  that  wish  to 
use  It.  The  second  section  Is  what  actually  performs  all 
the  commands. 

First,  a  set  of  routines  must  be  written  which  allow  a 
device  to  be  opened,  closed  and  expunged  (totally  removed 
from  memory).  These  are  exactly  the  same  as  for  a  library. 
On  top  of  these  functions,  two  extra  functions  must  be 
defined  -  BeglnlO  and  AbortlO.  BeglnlO  is  a  call  which 
tries  to  Immediately  perform  the  10  operation  without  using 
the  message  port.  If  the  operation  cannot  be  done 
immediately,  then  the  command  must  be  queued  by  sending  It 
to  the  message  port.  This  allows  simple  status  commands  to 
be  performed  very  quickly.  The  AbortlO  command  tries  to 
abort  an  existing  command. 

One  problem  with  writing  a  driver  In  C  code  Is  that 
Exec  passes  parameters  for  these  calls  in  registers.  This 
means  that  some  pieces  of  assembler  must  be  written  to  push 
the  registers  onto  the  stack  before  calling  the  C  code. 

Note  that  as  the  operating  system  Is  calling  functions 
written  in  C  directly.  If  the  C  compiler  requires  special 
values  In  the  registers  then  the  code  will  not  work.  For 
example,  I  have  heard  that  the  Aztec  C  compiler  uses  a 
register  to  point  to  the  global  variables.  If  this  Is  the 
case,  then  this  register  must  be  set  up  (probably  by  the 
same  code  that  pushes  the  registers  onto  the  stack)  before 
the  actual  C  function  can  be  called. 

Once  these  routines  are  written  a  device  structure 
(struct  Device)  must  be  created  using  the  MakeLlbraryO 
call.  MakeLlbraryO  accepts  a  pointer  to  an  area  of  memory 
that  defines  how  the  library  node  Is  to  be  Initialized  (see 
the  function  InltStructO).  However  It  Is  very  difficult  to 
set  up  the  necessary  memory  area  for  InltStructO  In  C  and 
so  I  simply  initialize  the  device  structure  after  calling 
MakeLlbraryO  using  normal  C  code.  Once  this  has  been  done, 
AddDevIceO  must  be  called  to  add  the  new  device  to  the 
system.  Once  AddDevIceO  has  been  called,  other  programs 
may  use  all  of  the  device  function  calls  previously 
mentioned  (OpenOevIceO  etc). 

The  example  device  driver  In  the  manual  creates  a  new 
process  for  each  unit.  Rather  than  trying  to  make  more 
problems  for  myself  by  trying  to  create  new  processes  from  a 
C  program,  and  as  I  only  have  a  single  unit  anyway,  I  did 
not  create  a  new  process  per  unit  but  rather  used  the  same 
process  that  creates  and  adds  the  device  node  to  receive  and 
process  commands.  So,  before  the  device  Is  actually  added 
to  the  system,  a  port  must  be  created  to  reel  eve  commands. 
The  Open  code  will  put  a  pointer  to  this  port  into  the  10 
request  block  which  was  passed  in  the  OpenDeviceO  call. 

This  is  how  DoI0()  and  SendlOO  know  where  to  send  the 
message. 


The  Hard  Disk  Device  Driver 

The  above  discussion  should  be  able  to  be  used  for  any 
type  of  device  driver  you  wish  to  write.  I  have  been 
considering  trying  to  write  a  printer  spooler  using  device 
drivers  too,  although  surely  someone  has  done  a  printer 
spooler  for  the  Amiga  before  (I  had  better  go  search  through 
all  the  PD  disks  I  guess). 

The  hard  disk  driver  must  emulate  the  trackdlsk  device 
driver  In  every  way.  Legal  requests  are  defined  In  chapter 
7  of  the  RKM:  libraries  and  devices  and  Include  such 
commands  as  read  data  from  disk,  write  data  to  disk,  format 
a  track,  switch  the  motor  on  and  so  on.  The  commands  are 
all  fairly  straight  forward.  The  hard  disk  driver  Is  much 
simpler  than  the  floppy  disk  driver  In  many  ways  as  the  disk 
cannot  be  removed! 

One  area  I  found  difficult  to  process  was  the  sector 
labels.  The  trackdlsk  device  actually  allows  an  extra  16 
bytes  per  sector  to  be  written  due  to  some  sector  header 
Information  on  the  disk.  The  hard  disk  controller  I  have 
does  not  allow  this.  As  a  result,  I  mark  any  commands  that 
try  to  use  this  Information  as  an  error.  So  far,  I  have  not 
foynd  any  code  that  actually  uses  this  Information  so  It  Is 
not  a  problem. 

The  trackdlsk  device  driver  (In  Vl.l  anyway)  buffers  a 
whole  track  of  the  disk  In  memory  at  a  time.  This  buffering 
of  data  In  memory  Is  referred  to  as  caching.  V1.2  does 
better  caching,  but  I  dont  know  how  (I  dont  have  all  the 
necessary  documentation  for  V1.2).  As  a  result,  I  tried  to 
add  some  of  my  own  more  Intelligent  caching.  Unfortunately, 
my  caching  seems  to  work  quite  well  for  about  5  minutes,  but 
then  It  hangs  the  system.  I  will  have  to  recheck  the  code 
sometime.  It  Is  difficult  to  determine  however  If  the 
caching  actually  Improves  the  speed  of  the  hard  disk  or 
whether  It  runs  slower  due  to  the  extra  code  that  needs  to 
be  executed.  The  extra  caching  certainly  uses  up  more 
memory,  so  at  this  stage  I  have  removed  all  caching.  Even 
without  caching,  Its  still  faster  than  floppies. 

My  hard  disk  driver  then  consists  of  a  number  of 
sections.  First,  when  It  Is  loaded  It  creates  and  adds  the 
device  node  to  the  system.  It  then  waits  for  comands  to 
arrive  from  a  message  port.  When  a  command  arrives,  a 
switch  statement  decides  what  code  to  execute  based  on  the 
command  type.  The  disk  read  and  write  type  commands  map  the 
offset  and  length  fields  In  the  command  message  onto  head, 
track  and  sector  numbers  which  Is  then  fed  to  the  hard  disk 
controller.  Other  commands  such  as  motor  on/off  and  disk 
change  count  can  be  easily  Immltated  (the  motor  can  never  be 
switched  off  and  the  disk  change  count  Is  constant). 

One  area  that  can  be  confusing  Is  that  the  code  that  Is 
needed  for  handling  open  and  close  device  calls  made  by 
programs  making  requests  to  the  driver  Is  never  executed  by 
the  device  driver  process.  When  the  device  Is  added  to  the 
system,  a  set  of  pointers  to  these  functions  Is  put  In  the 
device  structure  allowing  other  tasks  to  execute  code. 

To  Install  the  driver  Involves  adding  a  few  lines  to 
the  S:STARTUP-SEQUENCE  file.  First  the  command  RUN 
L:HARDDISK  (where  L:HARDDISK  Is  my  device  driver  program) 
starts  up  the  device  driver.  Next  the  command  MOUNT  DHO: 
notifies  AmlgaDOS  that  the  device  can  be  used  as  a  disk. 

For  the  mount  command  to  work,  the  file  DEVS:MOUNTLIST  must 
have  an  entry  for  DHO:  added.  The  file  on  my  disk  had  an 
example  entry  for  DF1:  so  I  just  copied  It  and  changed  the 
fields  (such  as  number  of  cylinders,  heads  etc)  for  my  hard 
disk.  The  name  of  the  device  driver  also  had  to  be  changed 
from  trackdlskjievlce  to  harddlsWevice.  I  have  also  added 
to  my  S:STARTUP-SEqUENCE  file  some  ASSIGN  commands  to  change 
the  C:  directory  to  be  on  the  hard  disk.  These  changes  need 
only  be  made  once  and  then  every  time  you  boot  up,  you  have 
a  very  big  disk  drive! 

One  problem  I  did  have  however  was  to  make  sure  that 
the  hard  disk  driver  was  actually  loaded  before  I  started 
using  It.  This  is  because  the  RUN  command  exits  before  the 
program  to  be  run  has  even  been  loaded  from  disk.  After  the 
RUN  command  I  put  In  a  delay  of  about  5  seconds  in  the 
S:STARTUP-SEQUENCE  file  so  that  the  driver  should  have  time 
to  load  completely. 
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Hardware 

This  is  a  brief  description  of  the  hardware  I  have 
used.  It  does  not  auto-configure  (oh  dear,  Commodore  win 
be  angry  with  me!)  as  I  could  not  work  out  exactly  how  to  do 
it.  I  have  a  copy  of  the  expansion  specs  from  Commodore  (I 
sent  off  to  the  states)  but  the  auto-configure  was  a  bit 
beyond  the  effort  I  wanted  to  go  to.  I  am  not  likely  to  add 
anything  else  to  my  Amiga  anyway  (famous  last  words).  The 
controller  card  I  used  has  8  registers  which  I  have  mapped 
into  memory  space.  Due  to  the  68000's  16  bit  words.  It 
ended  up  using  16  bytes  of  memory,  the  high  bytes  of  the  16 
bit  words  not  being  used.  The  controller's  registers  can  be 
read  from  or  written  to  and  Include  cylinder  number 
registers,  status  registers,  command  registers  and  so  on. 

Sending  commands  to  the  hard  disk  simply  Involves 
storing  the  relevant  parameters  In  the  controllers  registers 
and  sending  a  command  such  as  read  a  sector,  write  a  sector 
or  format  a  track.  All  this  Is  done  by  simple  memory  read 
and  write  commands.  I  ended  up  putting  the  controller  card 
at  the  top  of  expansion  memory  at  $9ffff0  (actually  I  do  not 
decode  the  address  to  that  precision,  but  Its  close).  As 
long  as  I  dont  expand  to  8  megs  of  memory,  It  should  not 
Interfere  with  anything  -  even  other  boards  which  do 
autoconfigure. 

After  sending  the  controller  a  command,  the  device 
driver  must  wait  for  the  command  to  finish.  I  tried  to  use 
the  Interrupt  line  provided  by  the  controller  card,  but  at 
this  stage  I  have  not  successfully  got  the  Interrupt 
handlers  on  the  amiga  to  work.  The  approach  I  am  currently 
using  Is  to  poll  the  status  register  of  the  controller. 
Polling  Is  where  the  program  sits  in  a  loop  continuously 
checking  the  status  register  until  the  command  has  finished. 
In  order  to  give  other  tasks  a  chance  to  run  while  the 
driver  Is  polling,  I  placed  a  call  to  DelayO  inside  the 
polling  loop.  The  delay  cannot  be  too  long  or  else  the  disk 
will  become  too  slow,  but  It  does  give  other  tasks  a  bit  of 
a  chance  to  run. 

Looking  at  the  side  of  the  Amiga,  the  expansion  bus  Is 
numbered  as  follows.  Reading  the  hardware  reference  manual 
seems  to  say  the  numbering  is  different  to  this,  but  this  Is 
what  I  used  (and  It  works).  I  would  check  the  signal 
numbers  before  building  this  circuit  In  case  of  Incorrect 
pin  numbers  due  to  typing  errors. 

1  3  5  7  9  .  85 

==================  the  edge  of  the  board 

2  4  6  8  10  .  86 

WARNING:  I  do  not  take  any  responsibility  If  the 
following  circuit  contains  any  errors.  All  I  can  say  Is 
that  it  has  not  blown  my  amiga  up  yet,  USE  AT  OWN  RISK! 

All  numbers  on  the  left  are  Amiga  signals.  All  numbers 
on  the  right  are  WD-1002-05  controller  signals.  Parts 
should  be  LS  or  better  for  speed.  All  signals  marked  *  are 
active  when  low  (Inverted).  Wires  that  cross  like  this: 


are  not  joined.  Joins  are  shown  by  -Ps  as  In  this: 


i  Pin  Connections 

21  A5 -  (not  used) 

24  A4 -  (not  used) 

26  A3 - RS2  21 

27  A2 . RSI  19 

29  A1 - RSO  17 

53  RES* - MR*  39 

75  POO - DALO  1 

77  PD1 - DALI  3 

79  PD2 . DAL2  5 

81  P03 - DAL3  7 

83  PD4 - DAL 4  9 

86  PD  5 . DAL  5  11 

84  PD6 - DAL6  13 

82  PD 7 - DAL7  15 
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A  May  To  ALIAS  Coaaands 

As  you  all  know  (don't  you?)  you  can  assign  logical 
volume/device  names  to  physical  disk  drive  names  such  as: 

assign  Source:  dfO: 
assign  Destination:  DF1: 
diskcopy  source:  to  destination: 

Useful?  Yes,  for  some  things.  Did  you  know  you  can 
also  assign  logical  volume/device  names  to  sub-directories? 
Such  as: 

assign  from:  df0:devs/pr1nters 
assign  to:  ram: 
copy  from:  to  to: 

*BUT*  the  *FUN*  one  you  may  not  have  noticed  Is  that  you 
can  assign  to  FILE  NAMES  (read  commands).  For  example: 

assign  x:  c:execute 
assign  e:  c:ed 
assign  cc:  dfl:c/LC 

then  use  them  like: 

x:  startup-sequence 
e:  my  text  file 
cc:  foo  -fdfl:  Include 

Assigns  are  SYSTEM  WIDE,  NOT  unique  to  each  window. 

Have  fun! 


AalgaDos  Filename  Hlldcardlng 

As  my  contribution  to  figuring  out  those  enigmatic 
commands  In  SYS:C,  here's  the  way  the  LIST  command  handles 
"wildcards"  In  filenames. 

If  you  want  to  see  all  the  files  with  names  ending  in  .c 
you  type 

LIST  PAT  #?.c 

or  LIST  P  #?.c 

All  the  files  with  names  beginning  with  A:  LIST  P  A#? 

All  the  files  with  four-letter  names:  LIST  P  ???? 

<?>  Is  the  wild-card  character,  and  <#?>  means  any 
number  of  <?>s.  Comparisons  Ignore  upper/lower  case 
distinctions. 

This  should  work  on  any  command  which  lists  the  option 
“-P=PAT/K-"  when  you  type  the  command  name  followed  by  a 
<?>:  e^.  LIST  ? 

This  and  some  other  options  which  seem  less  useful  than 
this  are  described  quickly  in: 

"TRIPOS  —  A  Portable  Operating  System  for  Mini-computers" 

Martin  Richards,  Aylward,  Bond,  Evans  and  Knight 
Software  Practice  and  Exper1ence_  Vol  9  pp  513-526  (1979) 

(TRIPOS  is  the  OS  on  which  AmlgaDos  Is  based) 

There  Is  a  longer  treatment  of  this  topic  in: 

"A  Compact  Function  for  Regular  Expression  Pattern  Matching" 

Martin  Richards 

_Software  Practice  and  Exper1ence_  Vol  9  pp  527-534  (1979) 

Isrft  It  a  pain  to  have  to  go  get  microfilmed  articles 
to  figure  out  how  to  use  a  computer  you  just  bought? 

To  the  Commodore-Amlga  people:  when  WILL  this  stuff  be 
available?  Surely  the  Users  Manual  for  the  OS  doesrft  need 
to  be  restricted  to  developers? 

Richard  Muller 
Computer  Studies  Program 
Hampshire  College 
Amherst  MA  01002 


ftalgaDos  Tricks 

The  following  tricks  may  be  of  Interest  to  CLI /AmlgaDos 
users. 

1.  First,  you  can  move  a  file  to  another  directory  without 
performing  a  copy  then  delete.  Use  the  RENAME  command 
and  specify  the  pathname  as  part  of  the  destination 
string. 

For  example: 

rename  lottahelp  newdlr/lottahelp 

moves  the  file  'lottahelp*  to  another  directory 
called  'newdlr*. 

You  can  even  give  the  file  a  different  name,  BUT-BUT- 
BUT,  you  can  only  move  files  from  one  device  to  another 
location  ON  THE  SAME  DEVICE.  You  cannot  move  a  file 
.from  RAM:  to  DF1:,  etc. 

2.  It  Is  possible  to  set  the  system  date/time  by 
redirecting  the  stdln.  But,  you  have  to  fool  DATE  by 
doing  the  following: 

DATE  <new1nf11e  [>n11:]  ? 

The  []  parameter  Is  optional  (do  not  Included  the  '[* 
’?  symbols).  It  will  redirect  the  output  of  the  DATE 
command  to  the  nil:  device. 

The  *?•  Is  used  to  fool  the  date  command  into  using 
•newlnflle'  as  the  Input  for  DATE. 


Midi  Interface  for  Amiga 

Professional  factory  produced,  using 
double-sided  board.  Unique  Australian 
design  which  minimises  cable  ratsnests 

12  month  warranty  on  Midi  box 

$99  plus  $15  sales  tax  plus  $5  postage 

These  prices  include  the  optional  $15 
extension  cable 

Dealer  enquiries  welcome 

Act  now,  stocks  available  from  your 
nearest  dealer  or  direct  from 


108  Mitchell  Street 
2  2  jj|  Bendigo,  Vic,  3550 

mic  ph  (°54)  43  2244 

COMPUTER 
SERVICE  PTY.  LTD. 

Public  bulletin  board  (054)  41  3013 
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Public  PcHBin  Update 

At  long  last,  the  Amicus  disks  have  finally  arrived! 
There  are  a  few  major  differences  between  these  disks  and  the 
Fred  Fish  collection:  these  disks  have  a  lot  of  programs  in 
Basic,  most  of  the  programs  are  in  source  code  only,  and  the 
disks  contain  icons  so  that  almost  everything  is  accessible 
from  the  Workbench. 

My  disk  of  the  month  Is  Amicus  99.  This  contains  the 
Boing!  demo  program  with  selectable  speed,  as  well  as  an 
Icon-based  way  to  set  the  time  and  date.  Also  worth  a  look 
Is  HyCLI,  a  very  Interesting  CLI  replacement. 

1*11  let  the  rest  of  the  volumes  speak  for  themselves. 

AbIcus  »1 


Aliases 

CLICard 

CLIConmands 

Commands 

EdCommands 

FIleNames 

Half Bright 

ModemPins 

RAMDIsks 

ROMWack 

Sounds 

Speed 

WackCmds 


explains  use  of  ASSIGN  command 

reference  card  for  AmlgaBOS  CLI 

guide  to  using  the  CLI 

shorter  guide  to  AmlgaDOS  CLI  conmands 

guide  to  the  EO  editor 

AmlgaDOS  filename  wildcard  conventions 

explains  newer  graphics  chips  that  can  do 

more  colours 

description  of  the  serial  port  pinout 
tips  on  setting  up  your  RAM:  disk 
tips  on  using  ROMWack 
explanation  of  the  Instrument  demo  sound 
file  format 

refutation  of  Amiga's  CPU  and  custom  chip 
speed 

tips  on  using  Wack 


ABasIC  prograa 

3Dsol1ds 

Blocks 

Cubes 

Durer 

FScape 

Hidden 

JPad 

Optical 

PalntBox 

Shuttle 

SpaceArt 

Speaker 

Sphere 

Spiral 

ThreeDee 

Topography 

Wheels 

Xenos 

ABasIC  progra 

AddressBook 

CardFIle 


Shapes 

Speaklt 

ABasIC  progra 

BrlckOut 

Othello 

Saucer 

Spelling 

ToyBox 

ABasIC  progrc 

Entertainer 

HAL9000 

Police 

Sugar PI urn 

C  programs 

ATerm 


:  Graphics 

-  3D  modeling  program  with  sample  data  files 
draws  blocks 

draws  cubes  , 

draws  pictures  In  the  style  of  Durer 

draws  fractal  landscapes 

3D  drawing  program  with  hidden 'line  removal 

Simple  paint  program 

draw  several  optical  illusions 

simple  pain  program 

draws  the  shuttle  in  3D  wireframe 

graphics  demo 

speech  utility 

draws  spheres 

draws  colour  spirals 

3D  function  plots 

Artificial  topography 

draws  circle  graphics 

draws  fractal  planet  landscapes 

Tools 

simple  database  program  for  addresses 
simple  card  file  database  program 
multiwindow  demo 

shows  keycodes  for  a  key  you  press 
run  many  ABasIC  programs  from  a  menu 
way  to  get  more  colours  on  the  screen  at 
once  using  aliasing 
simple  color  shape  designer 
speech  and  narator  demo 
s:  Gases 

classic  computer  brick  wall  game 
also  known  as  "Reversl” 
simple  shoot-em-up  game 
simple  talking  spelling  game 
selectable  graphics  demo 
s:  Sounds 

plays  that  tune 

pretends  Its  a  real  computer 

simple  police  siren  sound 

plays  "The  dance  of  the  Sugar  Plum  Fairies" 


ATerm  simple  terminal  program  SE 

cc  aid  to  compiling  with  Lattice  C 

Decvnt  opposite  of  CONVERT  for  cross  developers 

Dotty  source  code  to  the  "dotty  window"  demo 

EchoX  unlx-style  filename  expansion,  partial  S+OD 

FasterFP  explains  use  ,of  fast-floating  point  math 

FixDate  fixes  future  dates  on  all  files  on  a  disk  SE 

FreeDraw  simple  Workbench  drawing  program  SE 

GfxMem  graphic  memory-usage  Indicator  SE 

Grep  searches  for  a  given  string  In  a  file  ED 

Ham  shows  off  the  hold-and-modlfy  method  of 

color  generation 

IBM2Am1ga  fast  parallel  cable  transfer  between  an  IBM 

and  an  Amiga 

Mandel  Mandelbrot  set  program  SE 

Moire  patterned  graphic  demo  SE 

ObjFIx  makes  Lattice  C  object  file  symbols  visible 

to  Wack  SE 

Quick  quick  sort  strings  routine 

Raw  example  sample  window  I/O 

SetLace  turns  on  Interlace  mode  SE 

Sparks  qlx-type  graphic  demo  SE 

Other  executable  programs 
SpeechToy  speech  demonstration 

WhichFont  displays  all  available  fonts 

Texts 

68020  describes  68020  speedup  board  from  CSA 


Amicus  #2 

C  programs 

Allb  AmlgaDOS  object  library  manager  SE 

Ar  text  file  archiver  program  SE 

FlxObj  auto-chops  executable  files 

Shell  simple  CLI  shell  SE 

Sq.Usq  file  compression  programs  SE 

YachtC  a  familiar  games  SE 

Make  a  simple  "make"  programming  utility  SE 

Emacs  early  version  of  the  Amiga  text  editor  SED 

Assembler  programs 

bsearch.asm  binary  search  code 

qsort.asm  qsortl).  function,  source  and  C  test  program 

setjmp.asm  setjmpO  code  for  Lattice  3.02 

SVprlntf  Unix  system  V  compatible  prlntfl) 

trees. o  Unix  compatible  tree()  function  OD 

John  Draper  Amiga  Tutorial 

Animate  describes  animation  algorithm 

Gadgets  tutorial  on  gadgets 

menus  learn  about  Intuition  menus 

Amicus  #3 

C  programs 

Xref  a  C  cross-reference  generator  SE 

6B1tColor  extra  half-bright  chip  gfx  demo  SE 

Chop  truncate  (chop)  files  down  to  size  SE 

CleanUp  removes  strange  characters  from  text  files 

CR2LF  converts  CRs  to  LFs  in  Amiga  files  SE  i 

Error  adds  compile  errors  to  a  C  file  S 

Hello  windows  example  from  the  RKM  S 

Kermlt  generic  Kermit  Implementation,  flakey,  no 

terminal  mode  SE 

Scales  sound  demo  plays  scales  SE 

SkewB  Rubik  cube  demo  In  hl-res  colours  SE 

AmlgaBasIc  programs 

Automata  cellular  automata  simulation 

CrazyElghts  card  game 

Graph  function  graphing  programs , 

WltchlngHour  a  game 

ABasIC  programs 

Casino  games  of  poker,  blackjack,  dice  and  craps 

Gomoku  a  game 

Sabotage  sort  of  an  adventure  game 

Other  executable  progress 

Dlsassem  a  68000  disassembler  ED 

DpSHde  shows  a  given  set  of  IFF  pictures  ED 

Arrange  a  text  formatting  program  ED 

Assembler  programs 

ArgoTerm  a  terminal  program  with  speech  output  and 

Xmodem  SE 

Amicus  *4 

Files  from  the  original  Amiga  Technical  BBS.  Note  that 
some  of  these  files  are  old,  and  refer  to  older  versions  of 
the  operating  system.  These  files  came  from  the  Sun  system 
that  served  as  Amiga  Technical  Support  HQ  for  most  of  1985. 
These  files  do  not  carry  a  warranty,  and  are  for  educational 
purposes  only.  Of  course,  that  doesn’t  necessarily  mean  they 
don't  work. 

Complete  and  nearly  up-to-date  C  source  to  'Image-ecP, 
an  early  version  of  the  Icon  Editor.  This  is  a  little 
flakey,  but  compiles  and  runs. 
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An  Intuition  demo.  In  full  C  source.  Including  files: 
demomenu.c,  demomenu2.c,  demoreqx,  getascll.c,  1demo.c, 
1demo.gu1de,  Idemo.make,  idemoallJi,  nodos.c  and  txwrltex 

addmem.c  add  external  memory  to  the  system 

bobtest.c  example  of  BOB  use 

consolelO.c  console  10  example 

creaport.c  create  and  delete  port 

creastdl.c  create  standard  10  requests 

creatask.c  creating  task  examples 

dlsklo.c  example  of  track  read  and  write 

dotty. c  source  to  the  "dotty  window"  demo 

dualplay. c  dual  playfleld  example 

flood. c  flood  fill  example 

freemap.c  old  version  of  "freemap" 

geltools.c  tools  for  Vsprites  and  BOBs 

gfxmem.c  graphics  memory  usage  Indicator 

hello.c  window  example  from  RKM 

Inputdev.c  adding  an  Input  handler  to  the  Input  stream 

joystlk.c  reading  the  joystick 

keybd.c  direct  keyboard  reading 

layertes.c  layers  example 

mousport.c  test  mouse  port 

ownllb.c, 

ownllb.asm  example  of  making  your  own  library  with 
Lattice 

paratest.c  tests  parallel  port  commands 

serltest.c  tests  serial  port  commands 

serisamp.c  example  of  serial  port  use 

prlnlntr.c  sample  printer  Interface  code 

prtbase.h  printer  device  definitions 

reglntes.c  region  test  program 

setlace.c  source  to  Interlace  on/off  program 

setparal 1  el .c  set  the  attributes  of  the  parallel  port 

setserial.c  set  the  attributes  (parity,  data  bits)  of 

the  serial  port 

slngplay.c  single  playfleld  example 

speechtoy.c  source  to  narrator  and  phonetics  demo 

tlmedely.c  simple  timer  demo 

timer. c  exec  support  timer  functions 

timrstuf.c  more  exec  support  timer  functions 

WhlchFont.c  loads  and  displays  all  the  available  system 
fonts 

process. 1, 

prtbase.1  assembler  Include  files 

Texts 

autorqstr.txt  warnings  of  deadlocks  with  autorequesters 
consoleIO.txt  copy  of  the  RKM  console  10  chapter 
d1skfont.txt  warning  of  disk  font  loading  bug 

fullfcnt.txt  list  of  Ideflnes,  macros,  functions 
inputdev.txt  preliminary  copy  of  the  Input  device  chapter 
license  Information  on  Workbench  distribution  license 

printer  pre-release  copy  of  the  chapter  on  printer 

drivers  from  RKM  1.1 

vllfd.txt  "dlff*  of  ,fd  file  changes  from  version  1.0 

to  1.1 

v28vl.d1ff  "dlff"  of  Include  file  changes  from  version 
28  to  1.0 

Amicus  #5 

Files  from  the  Amiga  Link/Amiga  Information  Network. 

Note  that  some  of  these  files  are  old,  and  refer  to  older 
versions  of  the  operating  system.  These  files  are  from  Amiga 
Link.  For  a  time,  Commodore  supported  Amiga  Link,  aka  AIN, 
for  online  developer  techlncal  support.  It  was  only  up  and 
running  for  several  weeks.  These  files  do  not  carry  a 
warranty,  and  are  for  educational  purposes  only.  Of  course, 
that’s  not  to  say  they  don't  work. 

C  programs 

whereis.c  find  a  file,  searching  all  subdirectories 

bobtest.c  BOB  programing  example 

sweep. c  sound  synthesis  example 

Assenbler  programs 

mydev.asm  sample  device  driver 

myllb.asm  sample  library  example 

mylib.i, 

mydev.i, 

asmsupp.1, 

macros. 1  assembler  include  files 

Texts 

amlgatricks  tips  on  CLI  commands 

extdisk  external  disk  specification 

gameport  game  port  specification 

parallel  parallel  port  specification 


serial  serial  port  specification 

vl.lupdate  list  of  new  features  in  version  1.1 
vl.lh.txt  "dlff"  of  Include  file  changes  from  version 

1.0  to  1.1 

Files  for  building  your  own  printer  drivers,  Including 
dospec1al.c,  epsondatax,  Inltasm,  printer.c,  prlnter.llnk, 
pr1ntertag.asm,  renderx,  and  walbasm.  This  disk  also 
contains  a  number  of  files  describing  the  IFF  specification. 
These  are  not  the  latest  and  greatest  files,  but  remain  here 
for  historical  purposes.  They  include  text  files  end  C 
source  examples.  The  lastest  IFF  specification  Is  elsewhere 
In  this .library. 

Aaleus  #6 

IFF  Pictures:  This  disk  Includes  the  DPSHde  program, 
which  can  view  a  given  series  of  IFF  pictures,  and  the 
"showplc"  program,  which  can  view  each  file  at  the  click  of 
an  icon,  and  the  "savellbm"  program,  to  turn  any  screen  Into 
an  IFF  picture.  The  pictures  Include  a  screen  from  ArtlcFox, 
a  Degas  dancer,  the  guys  at  Electronic  Arts,  a  gorilla, 
horses.  King  Tut,  a  lighthouse,  a  screen  from  Marble  Madness, 
the  Bugs  Bunny  martian,  a  still  from  an  old  movie,  the  Dire 
Straits  moving  company,  a  screen  from  Pinball  Construction 
Set,  a  TV  Newscaster,  the  Paint  Can,  a  world  map,  a  Porsche, 
a  shuttle  mission  patch,  a  tyrannosaurus  rex,  a  planet  view, 
a  VISA  card,  and  a  ten-speed  bike. 

jtaicus  #7 

DlglVIew  HAM  demo  picture  disk:  This  disk  has  pictures 
from  the  Dlgl-Vlew  hold-and-modlfy  video  digitiser.  It 
Includes  the  ladles  with  pencils  and  lollypops,  the  young 
girl,  the  bulldozer,  the  horse  and  buggy,  the  Byte  cover,  the 
dictionary  page,  the  robot  and  robert.  This  Includes  a 
program  to  view  each  picture  separately,  and  all  together  as 
separate,  slidable  pictures. 

Amicus  98 

C  programs 

Browse  view  text  files  on  a  disk  using  menus  SED 

Crunch  removes  comments  and  white  space  from  C  files 

IconExec  execute  CLI  commands  from  Workbench  SE 

PDScreenDurrp  dumps  rastport  of  highest  screen  to  printer 

SetAlternate  sets  a  second  Image  for  an  Icon,  when 

clicked  SE 

SetWIndow  makes  windows  for  a  CLI  program  to  run  under 

Workbench  SE 

SmallClock  a  small  digital  clock  that  sits  In  a  window 
menu  bar 

Scrlmper  the  screen  printer  In  the  fourth  Amazing 

Computing  SE 
ftslga Basic  programs 

(Note:  Many  of  these  programs  are  present  on 
Amicus  disk  #1.  Several  of  these  were 
converted  to  AmlgaBasIc,  and  are  Included 
here) 

AddressBook  a  simple  address  book  database 
Ball  draws  a  ball 

Cload  program  to  convert  CompuServe  hex  files  to 

binary 

Clue  the  game.  Intuition  driven 

ColorArt  art  drawing  program 

DeluxeDraw  drawing  program  In  the  third  Issue  of 
Amazing  Computing  SD 

Eliza  conversational  computer  program 

Othello  the  game 

RatMaze  3D  ratmaze  game 

R0R  boggling  graphics  demo 

Shuttle  draws  3D  pictures  of  the  space  shuttle 

Spelling  simple  spelling  program 

YoYo  wlerd  zero-gravity  yo-yo  demo,  tracks  yo-yo 

to  the  mouse 
Executable  programs 

3Dcube  Modula-2  demo  of  a  rotating  cube 

Altlcon  sets  a  second  Icon  Image,  displayed  when  the 

icon  Is  clicked 

AmlgaSpell  a  slow  but  simple  spelling  checker  ED 

Arc  the  ARC  file  compression  utility,  must-have 

for  telecommunicating  ED 
Bertrand  graphics  demo 

DiskSalvage  a  program  to  rescue  trashed  disks  ED 

KwikCopy  a  quick  but  nasty  disk  copy  program,  Ignores 

errors  ED 
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LlbDir  lists  hunks  In  an  object  file  ED 

SavelLBM  saves  any  screen  as  an  IFF  picture 

ScreenDump  shareware  screen  dump  program,  E  only 
StarTerm  terminal  program,  xmodem,  version  2  ED 

Texts 

LattlceMain  tips  on  fixing  main.c  In  Lattice 
GDiskDrlve  make  your  own  5725  drive 

GuruMed  explains  the  Guru  numbers 

Lat3.03bugs  bug  list  of  Lattice  C  version  3.03 
MForgeRev  user's  view  of  MIcroForge  hard  disk  drive 

PrlntSpooler  execute-based  print  spooling  program 

.MAP  files 

These  are  the  necessary  links  between 
AmlgaBasIc  and  the  system  libraries.  To 
take  advantage  of  the  Amiga's  capabilities 
In  Basic,  you  need  these  files.  BMAPs  are 
Included  for  'cllstf,  •console’,  'dlskfonf, 
•exec*,  'Icon',  'Intuition',  'layers', 
'mathffp*,  'mathleeedoubas', 
mathleeeslngbas',  'mathtrans',  'potgo', 
•timer'  and  'translator1. 

Amicus  §9 

Asa Iga Basic  programs 

FllghtSIm  simple  flight  simulator  program 

HuePalette  explains  Hue,  Saturation,  and  Intensity 

Requester  example  of  doing  requesters  from  Amiga  Basic 

ScrollDemo  demonstrates  scrolling  capabilities 

Synthesiser  sound  program 

WorldMap  Draws  a  map  of  the  world 

Executable  programs 

Bolng!  latest  Bolng!  demo,  with  selectable  speed  E 

Brush2C  converts  an  IFF  brush  to  C  data 

Instructions,  Initialisation  code  E 
Brush21con  converts  IFF  brush  to  an  icon  E 

Dazzle  graphics  demo,  tracks  to  mouse 

DecIGEL  assembler  program  for  stopping  68010  errors 

Klock  menu-bar  clock  and  date  display  E 

life  the  game  of  life  E 

TlmeSet  Intuition-based  way  to  set  the  time  and  date 

EMEmacs  another  EMACS,  more  oriented  to  word¬ 

processing  SED 

MyCLI  a  CLI  shell,  works  without  the  workbench  SED 

Texts 

FnctnKeys  explains  how  to  read  function  keys  from 

AmlgaBasIc 

HackerSIn  explains  how  to  win  the  game  'hacker' 

lst68010  guide  to  Installing  a  68010  In  your  Amiga 

PrlnterTIp  tips  on  sending  escape  sequences  to  your 
printer 

StartupTIp  tips  on  setting  up  your  startup-sequence 
file 

XfrmrRevlew  list  of  programs  that  work  with  transformer 
Printer-Drivers 

Printer  drivers  for:  Canon  PJ-1080A,  C  Itoh 
Prowriter,  an  Improved  Epson  driver  that 
eliminates  streaking,  Gemini  Star-10,  NEC 
8025A,  Okidata  ML-92,  Panasonic  KX-PIOxx 
family,  and  Smith  Corona  D300,  with  a 
document  describing  the  Installation 
process. 

ftricus  #10 

This  Is  an  Icon-driven  demo,  circulated  to  many  dealers. 
It  Includes  the  sounds  of  an  acoustic  guitar,  an  alarm, 
banjo,  calliope,  car  horn,  claves,  water  drip,  electric 
guitar,  flute,  harp  arpeglo,  klckdrum,  marimba,  organ  minor 
chord,  people  talking,  pigs,  pipe  organ,  rhodes  piano, 
saxaphone,  sltar,  snare  drum,  steel  drum,  bells,  vlbrophone, 
violin,  walling  guitar,  horse  whinny  and  whistle. 

Amicus  *11 

C  programs 

dlrutll  Intuition-based  CLI  replacement  file  manager 

cprl  shows  and  adjusts  priority  of  CLI  processes 

ps  shows  info  about  CLI  processes  SE 

vldtex  displays  CompuServe  RLE  pictures  SE 

AraigaBasic  programs 

polntered  pointer  and  sprite  editor  program 

optimize  optimization  example  from  A  C  article 

calendar  large,  animated  calendar,  diary  and  date 

book  program 

amortize  loan  amortizations 


brushtoBOB  converts  small  IFF  brushes  to  AmlgaBasIc  BOB 
objects 

grids  draw  and  play  waveforms 

hllbert  draws  hllbert  curves 

madllb  mad  lib  story  generator 

malltalk  talking  mailing  list  program 

meadows. 3D  3D  graphics  program,  from  Amazing  Computing 

article 

mousetrack  muse  tracking  example  In  hires  mode 

slot  slot  machine  game 

tictactoe  the  game 

switch  pachlnko-llke  game 

weird  makes  strange  sounds 

Executable  programs 

cp  unix-llke  copy  conmand  E 

els  clear  screen  program  SE 

dlff  unix-llke  stream  editor  uses  "dlff"  output 

to  fix  files 

pm  chart  recorder  performances  Indicator 

Assembler  programs 

cl s  screen  clear  and  CLI  arguments 

Modula-2 

trails  moving-worm  graphics  demo 

caseconvert  converts  modula-2  keywords  to  uppercase 

Forth  Breshehan  circle  algorithm  example 

Analyse  12  templates  for  the  spreadsheet  Analyze! 

Other  files 

There  are  four  programs  here  that  read 
Commodore  64  picture  files.  They  can 
translate  Koala  Pad,  Doodle,  Print  Shop  and 
News  Room  graphics  to  IFF  format.  Of 
course,  getting  the  files  from  your  C-64  to 
your  Amiga  Is  the  hard  part. 


Using  the  Amiga  as  a  Presentation  Tool 

During  1986,  as  part  of  the  requirements  of  the 
maths/computer  science  degree  at  Swinburne,  I  had  to  give  a 
one  hour  seminar  on  some  area  of  management  allied  to 
mathematics.  Being  an  ex  chalkle,  this  did  not  worry  me, 
however  the  weighting  of  25%  of  the  available  marks  meant 
that  the  presentation  was  very  Important. 

Well,  I  thought,  let's  show  this  lot  of  IBM  loving 
clowns  what  a  real  machine  can  do.  I'll  use  my  Amiga  to  do 
the  presentation.  DPSHde  will  do  the  trick. 

Firstly,  I  researched  the  topic  (always  a  good  Idea)  and 
made  up  a  rough  draft  of  the  areas  I  wished  to  cover.  Out 
came  Deluxe  Paint  and  I  made  up  a  set  of 'slides'  that 
covered  the  main  points  of  the  talk;  It  was  great  to  be  able 
to  specify  text  colour,  size,  font  and  positioning  on  the 
screen,  and  to  draw  graphs  easily  and  neatly. 

This  Is  looking  good,  I  mused,  but  something  more 
spectacular  is  required.  At  the  moment  all  I've  got  Is  a 
very  expensive  overhead  projector.  Then  It  struck  me:  I'll 
Include  some  digitized  Images. 

I  searched  through  my  PD  disks  and  found  some 
appropriate  material.  I  also  approached  Maxwells  and  they 
kindly  let  me  copy  their  dlglvlew  presentation  slides. 
Combining  both  sources  gave  some  magnificent  (and 
appropriate)  Images.  I  also  Included  some  cartoons  and 
drawings  to  break  the  tension  of  the  talk  and  to  point  out 
some  aspect  In  a  humorous  way. 

The  actual  seminar  went  very  well.  The  Images  (about 
40)  paced  the  talk  very  nicely,  and  the  cartoons,  digitized 
Images  etc.  Impressed  the  lecturers  and  other  students 
enormously. 

As  a  method  of  presentation  this  beats  virtually  any 
other  method  hands  down,  I  would  recommend  it  highly. 

-  Mike  Creek 
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Editorial 

Well,  most  of  you  seem  to  have  missed  out  on  the 
premiere  social  event  of  the  year.  Yes,  I'm  talking  about 
the  First  Annual  AUG  Barbecue.  The  weather  was  fine  and 
everyone  enjoyed  themselves.  About  20  AUG  members  and  their 
friends/lovers/families  managed  to  have  a  great  time,  without 
a  single  computer  In  sight! 

If  you  look  at  this  newsletter  closely,  you*ll  see  that 
we've  got  a  new  address,  PO  Box  48,  Boronla,  3155  (In  fact, 
you’d  hardly  have  to  look  closely  -  the  address  is  mentioned 
10  times!).  There  are  a  number  of  reasons  for  the  change. 

When  the  group  was  born,  there  were  no  post  office  boxes 
available,  so  we  "piggy-backed"  on  Ron  Wall's  personal  P.0, 
box.  Six  months  or  so  later,  the  box  we  had  applied  for  In 
Boronla  became  available.  We  didn't  do  anything  about  It 
then,  because  it  was  still  convenient  to  use  Ron's.  Then,  a 
few  months  back,  Ron  moved  from  North  Balwyn  to  Blackburn. 
This  has  made  the  mall  a  little  hard  to  pick  up,  which  has 
delayed  our  answers  to  your  letters  and  orders. 


The  other  problem  which  has  forced  the  change  Is  that 
the  group  has  grown  so  large  so  quickly  that  we  have  been 
overwhelmed.  We  now  have  over  370  members,  and  It  takes  a 
great  deal  of  time  to  answer  all  the  letters,  enquiries  and 
disk  orders.  We  apologise  for  the  delays,  and  hope  that  the 
change  of  address  will  help  us  serve  you  faster.  Instead  of 
one  person  (1e  Ron)  emptying  the  box  infrequently,  and  then 
having  to  do  most  of  the  work  involved  in  disk  copying  and 
answering  letters,  etc.,  we  are  going  to  spread  the  workload 
out  over  more  people. 

A  few  people  have  asked  why  we  don't  copy  the  public 
domain  disks  at  club  meetings  anymore.  The  problem  Is  that 
no-one  wants  to  miss  the  meetings!  If  someone  with  a  two  (or 
more)  drive  machine  Is  prepared  to  bring  their  machine  and 
copy  disks  at  the  meetings,  then  please  do! 

--  Peter  Jetson 


Application  for  mtmfoership  of  The  Amiga  Users  Group 

Membership  Is  $20  per  year.  Make  cheques  payable  to  The  Amiga  Users  Group,  and  send  to: 


Amiga  Users  Group, 

Surname: _ _ _ _ _ 

First  name:  _ _ (no  initials) 

Address: _ _ _ 

_  Postcode:  _ 

Where  did  you  hear  about  AUG:  _ 

How  can  AUG  help  you: _ _ 


Signed: _ . _  Date: _ 

In  the  event  of  my  admission  as  a  member,  I  agree  to  abide  by 
the  rules  of  the  Association  for  the  time  being  in  force. 


Box  48,  Boronla,  3155 

Details  this  side  are  optional 

Phone  number: _ _ _  STD  code: _ 

Year  of  birth: _ _ _ _ _ 

Occupation:  _ _ _ _ _ _ 

Interests:  _ _ _ 

Dealer's  Name: _ _ _ 

Dealer's  Address: _ _ _ _ 

_ _ _  Postcode: _ _ 

Are  you  happy  with  your  dealer: _ . 
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Campbell  Cray 
RMIT  Comm  Eng  Dept 
Box  2476V 

Melbourne  3001 
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